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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 

1 Scope 

This 3GPP Technical Specification (TS) specifies: 

1. The interactions between the HSS (Home Subscriber Server) and the SIP AS (Application Server) and 
between the HSS and the OSA SCS (Service Capability Server). This interface is referred to as the Sh 
reference point. 

2. The interactions between the SIP AS and the SLF (Subscription Locator Function) and between the OSA SCS 
and the SLF. This interface is referred to as the Dh reference point. 

The IP Multimedia (IM) Core Network Subsystem stage 2 is specified in 3GPP TS 23.228 [1] and the signalling flows 
for the IP multimedia call control based on SIP and SDP are specified in 3GPP TS 24.228 [2]. 

The IP Multimedia (IM) Session Handling with the IP Multimedia (IM) call model is specified in 3GPP TS 23.218 [4]. 

This document addresses the signalling flows and message contents for the protocol at the Sh and Dh interface. 

This document also addresses how the functionality of Ph interface is accomplished. 

The Presence Service Stage 2 description (architecture and functional solution) is specified in 3GPP TS 23.141 [18]. 



References 



[1] 3GPP TS 23.228: "IP Multimedia (IM) Subsystem - Stage 2". 

[2] 3GPP TS 24.228: "Signalling flows for the IP multimedia call control based on SIP and SDP 

(Release 5)". 

[3] 3GPP TS 23.002 "Network architecture". 

[4] 3GPP TS 23.218: "IP Multimedia (IM) Session Handling; IP Multimedia (IM) call model" 

[5] 3GPP TS 29.329: "Sh Interface based on Diameter - Protocol details" 
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[6] 3GPP TS 29.228: "IP multimedia (IM) Subsystem Cx Interface; Signalling flows and Message 

Elements". 

[7] 3GPP TS 29.229: "Cx and Dx Interfaces based on the Diameter protocol ; Protocol details" 

[8] IETF RFC 3588 "Diameter Base Protocol" 

[9] ITU-T recommendation Q.763: "Signalling System No. 7 - ISDN User Part formats and codes" 

[10] 3GPP TS 23.018: "Basic Call Handling; Technical realization" 

[11] 3GPP TS 23 .003 : "Numbering, Addressing and Identification" 

[12] 3GPP TS 23.032: "Universal Geographical Area Description (GAD)" 

[13] 3GPP TS 29.002: "Mobile Application Part (MAP) specification" 

[14] 3GPP TS 23.078: "Customised Applications for Mobile network Enhanced Logic (CAMEL) Phase 

3 - Stage 2" 

[15] IETF RFC 2045: "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet 

Message Bodies" 

[16] IETF RFC 3261 : "SIP: Session Initiation Protocol" 

[17] IETF RFC 3966: "The tel URI for Telephone Numbers" 

[18] 3GPP TS 23.141: "Presence Service; Architecture and Functional Description" 

[19] 3GPP TS 23.012: "Location Management Procedures" 

[20] ANSI X3.4: "Coded Character Set - 7-bit American Standard Code for Information Interchange" 

[21] draft-dawes-sipping-debug-event-00 (May 2008): "A Session Initiation Protocol (SIP) Event 

Package for Debugging" 

Editor's note: The above document cannot be formally referenced until it is published as an RFC. 

3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply. 

IP Multimedia session: IP Multimedia session and IP Multimedia call are treated as equivalent in this specification. 

Transparent data: Data that is understood syntactically but not semantically by the HSS. It is data that an AS may 
store in the HSS to support its service logic. One example is data that an AS stores in the HSS, using it as a repository. 

Non-transparent data: Data that is understood both syntactically and semantically by the HSS. 

AS (Application Server): a term used to denote either of a SIP Application Server or an OS A Service Capability 
Server. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AS Application Server 

CSCF Call Session Control Function 

C Conditional 

HSS Home Subscriber Server 
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IE 


Information Element 


IP 


Internet Protocol 


IM 


IP Multimedia 


IMS 


IP Multimedia Subsystem 


M 


Mandatory 





Optional 


SIP 


Session Initiation Protocol 


SLF 


Subscription Locator Function 


S-CSCF 


Serving CSCF 



Main Concept 



This document presents the Sh interface related functional requirements of the communicating entities. 
It gives a functional classification of the procedures and describes the procedures and message parameters. 
Error handling flows, protocol version identification, etc. procedures are also included. 

5 General Architecture 

This section further specifies the architectural assumptions associated with the Sh reference point, building on 3GPP 
TS 23.228 [1], 3GPP TS 23.218 [4] and also the Ph reference point building upon 3GPP TS 23.141 [18]. 

5.1 Functional requirements of network entities 

5.1 .1 Functional Requirements of the Application Server 

The Application Server may communicate with the HSS over the Sh interface. 

For functionality of the Application Server refer to 3GPP TS 23.002 [3], 3GPP TS 23.228 [1] and 3GPP TS 23.218 [4]. 

5.1 .2 Functional requirements of HSS 

The HSS may communicate with the Application Server over the Sh interface and with the Presence Network Agent 
over the Ph interface. The functionality of the Ph interface shall be the same as the functionality of the Sh interface. 

For functionality of the HSS refer to 3GPP TS 23.002 [3], 3GPP TS 23.228 [1] and 3GPP TS 23.218 [4]. 

5.1 .3 Functional Requirements of the Presence Network Agent 

The Presence Network Agent may communicate with the HSS over the Ph interface. In this case, all references to an 
Application Server in this specification apply also to a Presence Network Agent. 

5.2 Functional classification of Sh interface procedures 

Operations on the Sh interface are classified in functional groups: 

1 . Data handling procedures 

- The download of data from the HSS to an AS. 

- The update of data in the HSS. 

2. Subscription/notification procedures 

- An AS can subscribe to receive notifications from the HSS of changes in data. 
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- The HSS can notify an AS of changes in data for which the AS previously had subscribed. 



Procedure Descriptions 



In the tables that describe the Information Elements transported by each command, each Information Element is marked 
as (M) Mandatory, (C) Conditional or (O) Optional. 

A mandatory Information Element (marked as (M) in the table) shall always be present in the command. If this 
Information Element is absent, an application error occurs at the receiver and an answer message shall be sent 
back to the originator of the request with the Result-Code set to DIAMETER_MISSING_AVP. This message 
shall also include a Failed- A VP AVP containing the missing Information Element i.e. the corresponding 
Diameter AVP defined by the AVP Code and the other fields set as expected for this Information Element. 

A conditional Information Element (marked as (C) in the table) shall be present in the command if certain 
conditions are fulfilled. 

- If the receiver detects that those conditions are fulfilled and the Information Element is absent, an application 
error occurs and an answer message shall be sent back to the originator of the request with the Result-Code 
set to DIAMETER_MISSING_AVP. This message shall also include a Failed- AVP AVP containing the 
missing Information Element i.e. the corresponding Diameter AVP defined by the AVP Code and the other 
fields set as expected for this Information Element. 

- If those conditions are not fulfilled, the Information Element shall be absent. If however this Information 
Element appears in the message, it shall not cause an application error and it may be ignored by the receiver 
if this is not explicitly defined as an error case. Otherwise, an application error occurs at the receiver and an 
answer message with the Result-Code set to DIAMETER_AVP_NOT_ALLOWED shall be sent back to the 
originator of the request. A Failed- AVP AVP containing a copy of the corresponding Diameter AVP shall be 
included in this message. 

- An optional Information Element (marked as (O) in the table) may be present or absent in the command, at the 
discretion of the application at the sending entity. Absence or presence of this Information Element shall not 
cause an application error and may be ignored by the receiver. 

When a procedure is required to determine the Public Identity used for an identity lookup in HSS and SLF, the HSS and 
SLF shall derive the Public Identity from the SIP URI or Tel URI contained in the Public -Identity AVP, if not already 
in canonical form as per 3GPP TS 23.003 [1 1], as described below: 

- If the Public-Identity AVP contains a SIP URI, the HSS and SLF shall follow rules for conversion of SIP URI 
into canonical form as specified in IETF RFC 3261 [16] chapter 10.3. 

If the Public -Identity AVP contains a Tel URI in E.164 format, the HSS and SLF shall remove visual separators 
and remove all URI parameters. 

Unknown permanent failure error codes shall be treated in the same way as DIAMETER_UNABLE_TO_COMPLY. 
For unknown transient failure error codes the request may be repeated, or handled in the same way as 
DIAMETER_UNABLE_TO_COMPLY. 

6.1 User data handling procedures 
6.1.1 Data read (Sh-Pull) 

This procedure is used between the AS and the HSS. The procedure is invoked by the AS and is used: 

- To read transparent and/or non-transparent data for a specified user from the HSS. 

This procedure is mapped to the commands User-Data-Request/ Answer in the Diameter application specified in 3 GPP 
TS 29.329 [5]. Tables 6.1.1.1 and 6.1.1.2 detail the involved information elements. 
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Table 6.1.1.1 : Sh-Pull 



Information 
element name 


Mapping to 

Diameter 

AVP 


Cat. 


Description 


User Identity 
(See 7.1) 


User-Identity 


M 


IMS Public User Identity, Public Service Identity, or MSISDN of the user for 

whom the data is required. 

See section 7.1 for the content of this AVP. 


Wildcarded PSI 
(See 7.1 A) 


Wildcarded- 
PSI 





If the request refers to a Wildcarded PSI, the AS may include the 
corresponding Wildcarded PSI in this information element. 

If this element is present, it should be used by the HSS to identify the identity 
affected by the request. If that is the case, the terms User Identity or Public 
Service Identity in the detailed behaviour refer to the Wildcarded PSI. 


Wildcarded 

Public User 

Identity (See 

7.1 B) 


Wildcarded- 
IMPU 





If the request refers to a Wildcarded Public User Identity, the AS may include 
the corresponding Wildcarded Public User Identity in this information element. 

If this element is present, it should be used by the HSS to identify the identity 
affected by the request. If that is the case, the terms User Identity or Public 
User Identity in the detailed behaviour refer to the Wildcarded Public User 
Identity. 


Requested data 
(See 7.3) 


Data- 
Reference 


M 


This information element indicates the reference to the requested information. 
The set of valid reference values are defined in 7.6. 


Requested 

Identity set (See 

7.11) 


Identity-Set 





If Data-Reference indicates that IMS Public Identities is the requested data 
set to be downloaded, this information element should be included. 

When this information element takes the value IMPLICITJDENTITIES, the 
HSS shall provide all non-barred IMS Public Identities that belong to the same 
implicit registration set as the IMS Public Identity included in the message in 
the User-Identity AVP. The MSISDN user identity is not applicable for this 
value. If the User Identity is a Public Service Identity, the HSS shall return 
only the User Identity in the request. 

When this information element takes the value ALIASJDENTITIES, the HSS 
shall provide all non-barred IMS Public User Identities that are in the same 
alias group as the IMS Public User Identity included in the message in the 
User-Identity AVP (see 3GPP TS 23.228 [1 ] for the definition of Alias Public 
User Identities). The MSISDN user identity is not applicable for this value. If 
the User Identity is a Public Service Identity, the HSS shall return only the 
User Identity in the request. 

When this information element takes the value REGISTEREDJDENTITIES, 
the HSS shall provide all non-barred IMS Public Identities whose state is 
registered, belonging to all Private Identities that the IMS Public Identity or 
MSISDN in the User-Identity AVP is associated with. If the User Identity is a 
Public Service Identity, the HSS shall return no identities in the response. 

When this information element takes the value ALLJDENTITIES, the HSS 
shall provide all non-barred IMS Public Identities, belonging to all Private 
Identities that the User Identity is associated with. 

If Data-Reference indicates that IMS Public Identities is the requested data 
set to be downloaded and this information element is not included, the HSS 
shall download the set of IMS Public Identities that would be downloaded if 
the value of this information element had been ALL IDENTITIES. 


Requested 

domain 

(See 7.2) 


Requested- 
Domain 


C 


This information element indicates the domains to which the operation is 
applicable. Check table 7.6.1 to see when it is applicable. 


Current 
Location 
(See 7.8) 


Current- 
Location 


C 


This information element indicates whether an active location retrieval has to 
be initiated or not. It shall be present if Location Information is requested. 
If this information element takes the value InitiateActiveLocationRetrieval (1) 
the HSS shall indicate to the MSC/VLR and/or SGSN the need to initiate an 
active location retrieval. 
Check table 7.6.1 to see when it is applicable. 
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Service 
Indication 
(See 7. 4) 


Service- 
Indication 


C 


IE that identifies, together with the User Identity included in the User-Identity 
AVP and Data-Reference, the set of service related transparent data that is 
being requested. 
Check table 7.6.1 to see when it is applicable. 


Application 

Server Identity 

(See 7.9) 


Origin-Host 


M 


IE that identifies the AS originator of the request and that is used to check the 
AS permission list. 


Application 

Server Name 

(See 7.10) 


Server-Name 


C 


IE that is used, together with the User Identity included in the User-Identity 
AVP and Data-Reference, as key to identify the filter criteria. 
Check table 7.6.1 to see when it is applicable. 


DSAI Tag (See 
7.14) 


DSAI-Tag 


C 


IE that is used, together with the User Identity included in the User-Identity 
AVP and Data-Reference, as key to identify the instance of Dynamic Service 
Activation Info (DSAI) requested. 
Check table 7.6.1 to see when it is applicable. 



Table 6.1.1.2: Sh-Pull Resp 



Information 
element name 


Mapping to Diameter 
AVP 


Cat. 


Description 


Result 
(See 7.5) 


Result-Code / 
Experimental_Result 


M 


Result of the request. 

Result-Code AVP shall be used for errors defined in the Diameter 
Base Protocol. 

Experimental-Result AVP shall be used for Sh errors. This is a 
grouped AVP which contains the 3GPP Vendor ID in the Vendor-Id 
AVP, and the error code in the Experimental-Result-Code AVP. 


Wildcarded PSI 
(See 7.1 A) 


Wildcarded-PSI 


O 


If the request refers to a specific PSI matching a Wildcarded PSI and 
the Wildcarded PSI AVP was not included in the request and is not 
included in the User-Data AVP, the HSS may include the 
corresponding Wildcarded PSI in this information element. This 
information may be used by the AS to identify the affected 
Wildcarded PSI. 


Wildcarded 

Public User 

Identity (See 

7.1 B) 


Wildcarded-IMPU 


O 


If the request refers to a Public User Identity matching a Wildcarded 
Public User Identity and the Wildcarded-IMPU AVP was not included 
in the request and is not included in the User-Data AVP, the HSS 
may include the corresponding Wildcarded Public User Identity in 
this information element. This information may be used by the AS to 
identify the affected Wildcarded Public User Identity. 


Data 
(See 7.6) 


User-Data 


C 


Requested data. This element shall be present if the requested data 
exists in the HSS and the AS has permissions to read it. 



6.1.1.1 



Detailed behaviour 



The conditions for the inclusion of Requested-Domain as an additional key to the requested data are described in table 
7.6.1. If repository data is requested, Service-Indication shall be present in the request. If initial filter criteria are 
requested, the Server-Name AVP shall contain the SIP URL of the AS that initiates the request; requests for initial filter 
criteria are limited to those initial filter criteria which are relevant to the requesting AS. If DSAI information is 
requested, the DSAI-Tag AVP shall be present. 

Upon reception of the Sh-Pull request, the HSS shall, in the following order: 

1. In the AS permission list (see section 6.2) check that the requested user data is allowed to be read (Sh-Pull) by 
this AS by checking the combination of the identity of the AS sending the request (identified by the Origin-Host 
AVP) and the supplied Data-Reference. 

If one or more Data References in the request are not allowed to be read, Experimental-Result shall be set to 
DIAMETER_ERROR_USER_DATA_CANNOT_BE_READ in the Sh-Pull Response. 

2. Check that the User Identity for whom data is asked exists in HSS. If not, Experimental-Result shall be set to 
DIAMETER_ERROR_USER_UNKNOWN in the Sh-Pull Response. 
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3. If the User Identity does not apply to the Data-Reference indicated in the request according to Table 7.6.1, 
Experimental-Result shall be set to DIAMETER_ERROR_OPERATION_NOT_ALLOWED in the Sh-Pull 
Response. 

3a. If Data-Reference is AliasesRepositoryData (20), check that the User Identity contains an IMS Public User 

Identity (any IMS Public User Identity in the group may be used as a key for the repository data of the group). If 
not, Experimental-Result shall be set to DIAMETER_ERROR_OPERATION_NOT_ALLOWED in the Sh-Pull 
Response. 

4. Check whether or not the data that is requested to be downloaded by the AS is currently being updated by 
another entity. If there is an update of the data in progress, the HSS may delay the Sh-Pull-Resp message until 
the update has been completed. The HSS shall ensure that the data returned is not corrupted by this conflict. If 
HSS is not able to delay the Sh-Pull-Resp message e.g. due to timeout the Experimental-Result-Code shall be set 
to DIAMETER_USER_DATA_NOT_AVAILABLE. 

5. The HSS shall include the data pertinent to the requested Data Reference in the User-Data AVP and if the HSS 
supports the Notif-Eff feature, the HSS shall include the data pertinent to all the requested Data References in the 
User-Data AVP. Combining Data Reference RepositoryData (0) and AliasesRepositoryData (20) in the same 
request is not supported and the HSS shall set the Result-Code to DIAMETER_UNABLE_TO_COMPLY in this 
case, otherwise the HSS shall set the Result-Code to DIAMETER_SUCCESS. This includes cases where the 
data is not available to the HSS. 

If both the AS and the HSS have determined via mutual feature evaluation to not support the Notif-Eff feature 
and in the case that requested data is not available to the HSS, the HSS shall not include the User-Data AVP in 
the Sh-Pull Response. If both the AS and the HSS support the Notif-Eff feature and none of the requested data is 
available to the HSS, the HSS shall not include the User-Data AVP in the Sh-Pull Response. 

If both the AS and the HSS support the Notif-Eff feature and some of the requested data is not available to the 
HSS, it shall be indicated as follows. Empty repository data shall be indicated with the RepositoryData or 
AliasesRepositoryData element that contains a Service Indication and a Sequence Number but does not contain a 
ServiceData element. Empty Public Identifiers shall be indicated with an empty Publicldentifiers element. Empty 
location information shall be indicated by an empty CSLocationlnformation and/or an empty 
PSLocationlnformation element. Empty elements of Sh IMS Data shall be indicated as follows. An empty S- 
CSCF name shall be indicated with empty SCSCFName element. If all iFCs for the user that are relevant for the 
AS are empty it shall be indicated with empty IFCs element. 

If there is an error in any of the above steps then the HSS shall stop processing and shall return the error code specified 
in the respective step (see 3GPP TS 29.329 [5] and 3GPP TS 29.229 [7] for an explanation of the error codes). 

If the HSS cannot fulfil the received request for reasons not stated in the above steps, e.g. due to a database error or 
empty mandatory data elements, it shall stop processing the request and set Result-Code to 
DIAMETER_UNABLE_TO_COMPLY. 

Otherwise, the requested operation shall take place and the HSS shall return the Result-Code AVP set to 
DIAMETER_SUCCESS. Result-Code DIAMETER_SUCCESS is used also if the requested data does not exist in the 
HSS i.e. when the HSS is indicating valid empty data elements. 

6.1 .2 Data Update (Sh-Update) 

This procedure is used between the AS and the HSS. The procedure is invoked by the AS and is used: 

To allow the AS to update the transparent (repository) data stored at the HSS for each IMS Public User Identity 
(for Public User Identities matching a Wildcarded Public User Identity, the transparent data shall be stored per 
Wildcarded Public User Identity, and not for each specific Public User Identity matching that Wildcarded 
Public User Identity) or Public Service Identity (for Public Service Identities matching a Wildcarded PSI, the 
transparent data shall be stored per Wildcarded PSI, and not for each specific Public Service Identity matching 
that Wildcarded PSI). 

To allow the AS to update the PSI Activation State of a distinct Public Service Identity in the HSS. 

To allow the AS to update the Dynamic Service Activation Info stored at the HSS. 

This procedure is mapped to the commands Profile-Update-Request/ Answer in the Diameter application specified in 
3GPP TS 29.329 [5]. Tables 6.1.2.1 and 6.1.2.2 detail the involved information elements. 
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Table 6.1.2.1 : Sh-Update 



Information 
element name 


Mapping to 
Diameter AVP 


Cat. 


Description 


User Identity 
(See 7.1) 


User-Identity 


M 


IMS Public User Identity or Public Service Identity for which data is 

updated. 

See section 7.1 for the content of this AVP. 


Wildcarded PSI 
(See 7.1 A) 


Wildcarded-PSI 





If the request refers to a Wildcarded PSI, the AS may include the 
corresponding Wildcarded PSI in this information element. 

If this element is present, it should be used by the HSS to identify the 
identity affected by the request. If that is the case, the terms User 
Identity or Public Service Identity in the detailed behaviour refer to the 
Wildcarded PSI. 


Wildcarded Public 

User Identity (See 

7.1 B) 


Wildcarded- 
IMPU 





If the request refers to a Wildcarded Public User Identity, the AS may 
include the corresponding Wildcarded Public User Identity in this 
information element. 

If this element is present, it should be used by the HSS to identify the 
identity affected by the request. If that is the case, the terms User 
Identity or Public User Identity in the detailed behaviour refer to the 
Wildcarded Public User Identity. 


Requested data 
(See 7.3) 


Data-Reference 


M 


This information element includes the reference to the data on which 
updates are required (possible values of the Data Reference are 
defined in Table 7.6.1). 


Data 
(See 7.6) 


User-Data 


M 


Updated data. 


Application Server 

Identity 

(See 7.9) 


Origin-Host 


M 


IE that identifies the AS originator of the request and that is used to 
check the AS permission list. 



Table 6.1.2.2: Sh-Update Resp 



Information 
element name 


Mapping to 
Diameter AVP 


Cat. 


Description 


Result 
(See 7.5) 


Result-Code / 
Experimental- 
Result 


M 


Result of the update of data in the HSS. 

Result-Code AVP shall be used for errors defined in the Diameter Base 
Protocol. 

Experimental-Result AVP shall be used for Sh errors. This is a grouped 
AVP which contains the 3GPP Vendor ID in the Vendor-Id AVP, and the 
error code in the Experimental-Result-Code AVP. 


Wildcarded PSI 
(See 7.1 A) 


Wildcarded-PSI 





If the request refers to a specific PSI matching a Wildcarded PSI and the 
Wildcarded-PSI AVP was not included in the request, the HSS may 
include the corresponding Wildcarded PSI in this information element. 
This information may be used by the AS to identify the affected 
Wildcarded PSI. 


Wildcarded 

Public User 

Identity (See 

7.1 B) 


Wildcarded- 
IMPU 





If the request refers to a Public User Identity matching a Wildcarded 
Public User Identity and the Wildcarded-IMPU AVP was not included in 
the request, the HSS may include the corresponding Wildcarded Public 
User Identity in this information element. This information may be used 
by the AS to identify the affected Wildcarded Public User Identity. 



6.1.2.1 



Detailed behaviour 



Within the Sh-Update Request, the keys to determine the updated data are part of the information element Data (See 
7.6). When data in the repository is updated (i.e. added, modified or removed) Service-Indication and Sequence- 
Number are also sent as part of the information element Data. 

Newly added transparent data shall be associated with a Sequence Number of in the Sh-Update Request. Sequence 

Number value is reserved exclusively for indication of newly added transparent data. 

Modified and removed transparent data shall be associated within the Sh-Update Request with a Sequence Number of 
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n+1 where n is the original Sequence Number associated with the transparent data before modification or removal. If n 
equals 65535, then the next modification or deletion of that transparent data shall be associated with a Sequence 
Number of 1 . 

Upon reception of the Sh-Update request, the HSS shall, in the following order: 

1. In the AS permission list (see section 6.2) check that the data that is requested to be updated (Sh-Update) by this 
AS, is allowed to be updated by checking the combination of the identity of the AS sending the request 
(identified by the Origin-Host AVP) and the supplied Data-Reference. 

- If the data is not allowed to be updated, Experimental-Result shall be set to 
DIAMETER_ERROR_USER_DATA_CANNOT_BE_MODIFIED in the Sh-Update Response. 

2. Check that the IMS Public User Identity or Public Service Identity in the request exists in the HSS. If not, 
Experimental-Result shall be set to DIAMETER_ERROR_USER_UNKNOWN in the Sh-Update Response. 

3. If the User Identity does not apply to the Data-Reference indicated in the request according to Table 7.6.1, 
Experimental-Result shall be set to DIAMETER_ERROR_OPERATION_NOT_ALLOWED in the Sh-Update 
Response. 

4. If Data-Reference is PSIActivation (18), then the HSS shall check that the User Identity contains a distinct 
Public Service Identity. If it does, then the HSS shall update the corresponding PSI Activation State and return 
the Result-Code AVP set to DIAMETER_SUCCESS. If it does not, then the Experimental-Result shall be set to 
DIAMETER_ERROR_OPERATION_NOT_ALLOWED in the Sh-Update Response. 

The change of a Public Service Identity from ACTIVE to INACTIVE shall trigger the network initiated 
deregistration of the Public Service Identity in the HSS. 

4a. If Data-Reference is DSAI (19), check whether or not, for the Public Identity, there is an instance of DSAI 
matching the DSAI-Tag contained in the Sh-Update command. If so, then the HSS shall update the DSAI value 
and return the Result-Code AVP set to DIAMETER_SUCCESS. If not, Experimental-Result shall be set to 
DIAMETER_ERROR_DS AI_NOT_AVAILABLE. 

The changes of DSAI value shall trigger the procedures described in section 7.14 in order to determine which 
initial filter criteria should be masked or unmasked. If these procedures change the set of unmasked initial filter 
criteria, the HSS should behave as if the initial filter criteria had been administratively changed, which implies 
e.g. sending Sh-Notif or Cx-Update_Subscr_Data messages (see 3GPP TS 29.228 [6]). 

5. Check whether or not the data that is requested to be updated by the AS, as identified by the Service-Indication, 
is currently being updated by another entity. If there is an update of the data in progress, Experimental-Result 
shall be set to DIAMETER_PRIOR_UPDATE_IN_PROGRESS in the Sh-Update Response. 

6. Check whether or not there is any repository data stored at the HSS already for the specified Service-Indication 
and the associated IMS Public User Identity (or group if Data-Reference is AliasesRepositoryData) or Public 
Service Identity. 

- If repository data identified by the Service-Indication is stored at the HSS for the specified IMS Public User 
Identity, IMS Public User Identity group or Public Service Identity, check the following premises: 

1 . Sequence_Number_in_Sh_Update is not equal to 

2. (Sequence_Number_in_Sh_Update - 1) is equal to (Sequence_Number_In_HSS modulo 65535) 

- If either of the above premises is false then Experimental-Result- shall be set to 

DIAMETER_ERROR_TRANSPARENT_DATA_OUT_OF_SYNC in the Sh-Update Response. 

If both of the above premises are true, then check whether or not Service Data is received within the Sh- 
Update Req. 

- If Service Data is included in the Sh-Update Req, check whether or not the size of the data is greater 
than that which the HSS is prepared to accept. 

- If there is more data than the HSS is prepared to accept then Experimental-Result shall be set to 
DIAMETER_ERROR_TOO_MUCH_DATA and the new data shall be discarded. 
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- If the HSS is prepared to accept the data, then the repository data stored at the HSS shall be 
updated with the repository data sent in the Sh-Update Req and the Sequence Number associated 
with that repository data shall be updated with that sent in the Sh-Update Req. This triggers the 
sending of Sh-Notif messages to any other ASs that are subscribed to Notifications for updates to 
the service data for that IMS Public User Identity or Public Service Identity (see 6.1.4). 

- If Service Data is not received, the data stored in the repository at the HSS shall be removed, and as a 
consequence the Service Indication and the Sequence Number associated with the removed data shall 
also be removed. This triggers the sending of Sh-Notif messages with that Service Indication and 
Sequence Number to be deleted but with an absent Service Data element, to any other ASs that are 
subscribed to Notifications for updates to the service data for that IMS Public User Identity or Public 
Service identity (see 6.1.4). After sending Sh-Notif messages, the subscriptions to Notifications for 
the removed Repository Data shall be deleted. 

- If repository data identified by the Service-Indication is not stored for the IMS Public User Identity, IMS 
Public User Identity group or Public Service Identity i.e. the Sh-Update Req intends to create a new 
repository data, check whether or not the Sequence Number in the Sh-Update Req is 0. 

- If the sequence number is not set to 0, Experimental-Result shall be set to 
DIAMETER_ERROR_TRANSPARENT_DATA_OUT_OF_SYNC 

- If the sequence number is set to check whether Service Data is included within the Sh-Update Req. 

- If Service Data is not included in the Sh-Update Req, then Experimental-Result shall be set to 
DIAMETER_ERROR_OPERATION_NOT_ALLOWED and the operation shall be ignored by the 
HSS. 

- If Service Data is included in the Sh-Update Req, check whether or not the size of the data is greater 
than that which the HSS is prepared to accept. If there is more data than the HSS is prepared to accept 
then Experimental-Result shall be set to DIAMETER_ERROR_TOO_MUCH_DATA and the new 
data shall be discarded. 

- If the HSS is prepared to accept the data included in the Sh-Update Req, then the data shall be stored 
in the data repository in the HSS. 

If there is an error in any of the above steps then the HSS shall stop processing and shall return the error code specified 
in the respective step (see 3GPP TS 29.329 [5] and 3GPP TS 29.229 [7] for an explanation of the error codes). 

If the HSS cannot fulfil the received request for reasons not stated in the above steps, e.g. due to database error, it shall 
stop processing the request and set Result-Code to DIAMETER_UNABLE_TO_COMPLY. 

Otherwise, the requested operation shall take place and the HSS shall return the Result-Code AVP set to 
DIAMETER_SUCCESS. 

NOTE: When an AS receives DIAMETER_ERROR_TRANSPARENT_DATA_OUT_OF_SYNC the AS may 
attempt to resolve the inconsitency between the version of the repository data that it holds and that stored 
at the HSS. It may execute a Sh-Pull to retrieve the current version of the data from the HSS or it may 
wait to receive a subsequent Sh-Notif message from the HSS for the affected repository data. 

6.1 .3 Subscription to notifications (Sh-Subs-Notif) 

This procedure is used between the AS and the HSS. The procedure is invoked by the AS and is used: 

- To subscribe to Notifications for when particular transparent and/or non-transparent data for a specified IMS 
Public User Identity or Public Service Identity is updated, from the HSS. 

- Optionally to request the user data from the HSS in the same operation. 

This procedure is mapped to the commands Subscribe-Notifications-Request/ Answer in the Diameter application 
specified in 3GPP TS 29.329 [5]. Tables 6.1.3.1 and 6.1.3.2 detail the information elements involved. 
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Table 6.1.3.1: Sh-Subs-Notif 



Information element 
name 


Mapping to 
Diameter AVP 


Cat. 


Description 


User Identity 
(See 7.1) 


User-Identity 


M 


IMS Public User Identity or Public Service Identity for which 
notifications of data changes are requested. See section 7.1 for the 
content of this AVP. 


Wildcarded PSI (See 
7.1 A) 


Wildcarded-PSI 


O 


If the request refers to a Wildcarded PSI, the AS may include the 
corresponding Wildcarded PSI in this information element. 

If this element is present, it should be used by the HSS to identify the 
identity affected by the request. If that is the case, the terms User 
Identity or Public Service Identity in the detailed behaviour refer to the 
Wildcarded PSI. 


Wildcarded Public 

User Identity (See 

7.1 B) 


Wildcarded- 
IMPU 


O 


If the request refers to a Wildcarded Public User Identity, the AS may 
include the corresponding Wildcarded Public User Identity in this 
information element. 

If this element is present, it should be used by the HSS to identify the 
identity affected by the request. If that is the case, the terms User 
Identity or Public User Identity in the detailed behaviour refer to the 
Wildcarded Public User Identity. 


Requested Data 
(See 7.3) 


Data-Reference 


M 


This information element includes the reference to the data on which 
notifications of change are required (valid reference values are 
defined in 7. 6). 


Subscription request 
type (See 7.7) 


Subs-Req-Type 


M 


This information element indicates the action requested on 
subscription to notifications. 


Send Data Indication 
(See 7.13) 


Send-Data- 
Indication 


O 


This information element requests that the data is sent in the 
response. 


Service Indication 
(See 7.4) 


Service- 
Indication 


C 


IE that identifies, together with the User Identity and Data-Reference, 
the set of service related transparent data for which notifications of 
changes are requested. 
Check table 7.6.1 to see when it is applicable. 


Application Server 
Identity (See 7.9) 


Origin-Host 


M 


IE that identifies the AS originator of the request and that is used to 
check the AS permission list. 


Application Server 
Name (See 7.10) 


Server-Name 


C 


IE that is used, together with the User Identity and Data-Reference, 

as key to identify the filter criteria. 

Check table 7.6.1 to see when it is applicable. 


Expiry Time (See 
7.12) 


Expiry-Time 


O 


Gives the absolute time requested at which the subscription expires. 


Dynamic Service 

Activation Information 

Tag (see 7.14) 


DSAI-Tag 


C 


IE that identifies, together with the User Identity and Data-Reference, 
the instance of Dynamic Service Activation Info (DSAI) requested. 
Check table 7.6.1 to see when it is applicable. 


Requested Identity set 
(See 7.11) 


Identity-Set 


C 


Check table 7.6.1 to see when it is applicable. 
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Table 6.1.3.2: Sh-Subs-Notif Resp 



Information 
element name 


Mapping to 
Diameter AVP 


Cat. 


Description 


Expiry Time 
(See 7.12) 


Expiry-Time 





Acknowledges the absolute time at which the subscription expires. 


Data (See 7.6) 


User-Data 





Current values of the data for which notifications have been requested. 

It should be present if the Send-Data-lndication AVP is set to value 
USER DATA REQUESTED. 


Wildcarded PSI 
(See 7.1 A) 


Wildcarded-PSI 





If the request refers to a specific PSI matching a Wildcarded PSI and the 
Wildcarded PSI AVP was not included in the request and is not included in 
the User-Data AVP, the HSS may include the corresponding Wildcarded 
PSI in this information element. This information may be used by the AS to 
identify the affected Wildcarded PSI. 


Wildcarded 

Public User 

Identity (See 

7.1 B) 


Wildcarded- 
IMPU 





If the request refers to a Public User Identity matching a Wildcarded Public 
User Identity and the Wildcarded-IMPU AVP was not included in the 
request, the HSS may include the corresponding Wildcarded Public User 
Identity in this information element. This information may be used by the 
AS to identify the affected Wildcarded Public User Identity. 


Result 
(See 7.5) 


Result-Code / 
Experimental- 
Result 


M 


Result of the request. 

Result-Code AVP shall be used for errors defined in the Diameter Base 
Protocol. 

Experimental-Result AVP shall be used for Sh errors. This is a grouped 
AVP which contains the 3GPP Vendor ID in the Vendor-Id AVP, and the 
error code in the Experimental-Result-Code AVP. 



6.1.3.1 



Detailed behaviour 



The HSS shall take note of the subscription request on the data identified by User Identity and Data-Reference. If 
notifications on changes of repository data are requested, Service-Indication shall be present in the request. If 
notifications on changes of filter criteria are requested, the Server-Name AVP shall be used as key to the filter criteria. 
If the request contains a specific Public Service Identity matching a Wildcarded PSI, the HSS shall interpret that the 
subscription refers to the information associated to the Wildcarded PSI. The Server-Name AVP shall contain the SIP 
URL of the AS sending the request. If notifications on changes of DS AI are requested, the DS AI-Tag AVP shall be 
used as key of the DS AI whose changes are to be monitored. 

Upon reception of the Sh-Subs-Notif request, the HSS shall, in the following order (if there is an error in any of the 
following steps the HSS shall stop processing and return the corresponding error code, see 3GPP TS 29.329 [5] and 
3GPPTS 29.229 [7]): 

1. In the AS permission list (see section 6.2) the HSS shall check that the AS is allowed to subscribe to 
notifications (Sh-Subs-Notif) for the requested data by checking the combination of the identity of the AS 
sending the request (identified by the Origin-Host AVP) and the supplied Data-Reference. 

- If this AS does not have Sh-Subs-Notif permission for the data referenced, Experimental-Result shall be set 
to DIAMETER_ERROR_USER_DATA_CANNOT_BE_NOTIFIED in the Sh-Subs-Notif Response. 

2. Check that the IMS Public User Identity or Public Service Identity in the request exists in HSS. If not, 
Experimental-Result shall be set to DIAMETER_ERROR_USER_UNKNOWN in the Sh-Subs-Notif Response. 

3. If the User Identity does not apply to the Data-Reference indicated in the request according to Table 7.6.1, 
Experimental-Result shall be set to DIAMETER_ERROR_OPERATION_NOT_ALLOWED in the Sh-Subs- 
Notif Response. 

3a. If Data-Reference is DSAI (19), check whether or not, for the Public Identity, there is an instance of DSAI 
matching the DS AI-Tag contained in the Sh-Subs-Notif command. If not, Experimental-Result shall be set to 
DIAMETER_ERROR_DS AI_NOT_AVAILABLE. 

4. If the Sh-Subs-Notif Request contains an Expiry Time, the HSS should also include in the Sh-Subs-Notif 
Response an Expiry Time IE with the absolute time at which the subscription expires in the case of a successful 
subscription. This time may be earlier than the requested expiry time. If the HSS includes this IE, then no 



ETSI 



3GPP TS 29.328 version 8.3.0 Release 8 1 7 ETSI TS 1 29 328 V8.3.0 (2009-01 ) 

notification shall be sent to the AS after the expiration time. If the HSS receives a Sh-Subs-Notif Request 
without the Expiry Time IE, the HSS should treat it as a request for an unlimited subscription. 

If the HSS does not include this IE in the response, that indicates an unlimited subscription. 

If a subsequent request is received by the HSS where the Expiry Time IE is present but different from what the 
HSS has previously stored, the HSS should replace the stored expiration time with what was received in the 
request. 

5. If Data-Reference is RepositoryData(O) or AliasesRepositoryData(20) and the transparent data associated with 
the Service Indication does not exist in the HSS, then Experimental-Result shall be set to 

DI AMETER_ERROR_SUB S_D AT A_AB SENT . 

6. If the Subscription request type information element indicates that this is a request to subscribe, the HSS shall 
associate the Application Server Identity with the list of entities that need to be notified when the data identified 
by the request is modified and set the Result-Code to DIAMETER_SUCCESS in the Sh-Subs-Notify response. 
If the Subscription request type information element indicates that this is a request to unsubscribe, the HSS shall 
remove the association of the Application Server Identity with the same list. In this last case, the Result-Code 
shall be set to DIAMETER_SUCCESS if the operation is successful or if the Application Server Identity was not 
present in the list. 

7. If the HSS and AS supports the Notif-Eff feature and if multiple Data-Reference AVPs occur in the Sh-Subs- 
Notif Request, each Data-Reference shall be treated as a request to establish a separate notification request. 
When mulitiple notification requests are requested, and all of them succeed, the HSS shall set the Result-Code to 
DIAMETER_SUCCESS in the Sh-Subs-Notify response. 

8. If the HSS and AS supports the Notif-Eff feature and if multiple Service-Indication AVPs occur in the Sh-Subs- 
Notif Request, each Service-Indication shall be treated as a request to establish a separate notification request for 
change of Transparent data. When mulitiple notification requests are requested, and all of them are successful, 
the HSS shall return the Result-Code set to DIAMETER_SUCCESS in the Sh-Subs-Notify response. 

9. If the Send Data Indication is present in the request and the HSS supports the return of the User-Data in this 
request, check whether or not the data that is requested to be downloaded by the AS is currently being updated 
by another entity. If there is an update of the data in progress, the HSS may delay the response until the update 
has been completed. The HSS shall ensure that the data returned is not corrupted by this conflict. 

10. If the Send Data Indication is present in the request, the HSS should include the data pertinent to the requested 
Data Reference in the User-Data AVP and if the HSS supports the Notif-Eff feature, the HSS should include the 
data pertinent to all the requested Data References in the User-Data AVP. Combining Data Reference 
RepositoryData (0) and AliasesRepositoryData (20) in the same request is not supported and the HSS shall set 
the Result-Code to DIAMETER_UNABLE_TO_COMPLY in this case, otherwise the HSS shall set the Result- 
Code to DIAMETER_SUCCESS. This includes cases where the data is not available to the HSS and an empty 
tag is included as follows. Empty elements of Sh IMS Data shall be indicated as follows. An empty S-CSCF 
name shall be indicated with empty SCSCFName element. If all iFCs for the user that are relevant for the AS are 
empty it shall be indicated with empty IFCs element. Similarly for PSI activation information. 

If the HSS cannot fulfil the received request for reasons not stated in the above steps, e.g. due to database error, it shall 
stop processing the request and set Result-Code to DIAMETER_UNABLE_TO_COMPLY. 

6. 1 .4 Notifications (Sh-Notif) 

This procedure is used between the HSS and the AS. The procedure is invoked by the HSS and is used: 

- To inform the AS of changes in transparent and/or non-transparent data to which the AS has previously 
subscribed to receive Notifications for, using Sh-Subs-Notif (see 6.1.3). 

This procedure is mapped to the commands Push-Notification-Request/ Answer in the Diameter application specified in 
3GPP TS 29.329 [5]. Tables 6.1.4.1 and 6.1.4.2 detail the involved information elements. 
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Table 6.1.4.1: Sh-Notif 



Information 
element name 


Mapping to 
Diameter AVP 


Cat. 


Description 


User Identity 
(See 7.1) 


User-Identity 


M 


IMS Public User Identity or Public Service Identity for which data has 

changed. 

If the request refers to a Wildcarded PSI, the HSS may include any PSI 

matching the corresponding Wildcarded PSI in this information 

element. The AS shall find the corresponding Wildcarded PSI with this 

information. 

See section 7.1 for the content of this AVP. 


Wildcarded PSI 
(See 7.1 A) 


Wildcarded-PSI 





If the request refers to a Wildcarded PSI, the HSS shall include the 
corresponding Wildcarded PSI in this information element. 

If this element is present, it shall be used by the AS instead of the User 
Identity to identify the identity affected by the request. 


Wildcarded Public 

User Identity (See 

7.1 B) 


Wildcarded- 
IMPU 





If the request refers to a Wildcarded Public User Identity, the HSS shall 
include the corresponding Wildcarded Public User Identity in this 
information element. 

If this element is present, it shall be used by the AS instead of the User 
Identity to identify the identity affected by the request. 


Data 
(See 7.6) 


User-Data 


M 


Changed data. 



Table 6.1.4.2: Sh-Notif Resp 



Information 
element name 


Mapping to 
Diameter AVP 


Cat. 


Description 


Result 
(See 7.5) 


Result-Code / 
Experimental-Result 


M 


Result of the request. 

Result-Code AVP shall be used for errors defined in the Diameter 
Base Protocol. 

Experimental-Result AVP shall be used for Sh errors. This is a 
grouped AVP which contains the 3GPP Vendor ID in the Vendor-Id 
AVP, and the error code in the Experimental-Result-Code AVP. 



6.1.4.1 



Detailed behaviour 



The keys to the updated data are part of the information element User-Data AVP. When data repository is updated 
Service-Indication and Sequence Number shall also be part of the information element User-Data. 

Since authentication pending is a transient state of normally very short duration, notification of an IMS user's state 
change, to and from the authentication pending state shall not be sent to Application Servers, when the previous state 
before authentication pending and next state after authentication pending are the same. If the states are different before 
the authentication pending state is entered and after the authentication pending state is left then notification is sent to the 
AS of this new state. 

If the HSS and AS supports the Notif-Eff feature and if multiple subscriptions to notifications are associated with a 
Public User Identity, the HSS may combine the notifications for multiple Data References and Service Indications into 
a single notification message. 

Removal of the subscribed data is indicated with the content of User-Data AVP. The content shall be compliant with the 
XML-schema defined in Annex D. Removed repository data shall be indicated with RepositoryData or 
AliasesRepositoryData element that does not contain ServiceData element. Removed S-CSCF name shall be indicated 
with empty SCSCFName element. If all iFCs for the user that are relevant for the AS have been removed it shall be 
indicated with empty IFCs element. 

Removal of Public Identity for which the AS has any active subscription other than IMSPublicIdentity (see table 
7.6.1)shall be indicated in the Deletedldentities element. 

Table 6.1.4.1 details the valid result codes that the AS can return in the response. 
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Table 6.1 .4.1 .1 : Sh-Notif response valid result codes 



Result-Code AVP value 


Condition 


DIAMETER SUCCESS 


The request succeeded. 


DIAMETER_ERROR_USER_DATA_NOT_RECOGNIZED 


The request failed. The AS informs the HSS that the received 
user information contained information, which was not 
recognized or supported by the AS. 


DIAMETER_ERROR_USER_UNKNOWN 


The request failed because the Public Identity is not found in 
the AS. 


DIAMETER_ERROR_TOO_MUCH_DATA 


The request failed. The AS informs the HSS that it tried to 
push too much data into the AS. 


DIAMETER_ERROR_NO_SUBSCRIPTION_TO_DATA 


The request failed. The AS informs the HSS that the 
notification refers to information to which the AS is not 
subscribed. 


DIAMETER_UNABLE_TO_COMPLY 


The request failed. 



6.2 AS permissions list 



In table 7.6.1, the contents of the Data- AVP are described. Some of the individual elements carried within Data- AVP 
may be requested by the AS from the HSS using the Sh-Pull command (see section 6.1.1) or may be updated at the HSS 
by the AS using the Sh-Update command (see section 6.1.2). The AS may also request that the HSS notifies the AS of 
changes to specific elements within the Data- AVP using the Sh-Subs-Notif command (see section 6.1.3). The HSS will 
only allow these operations to take place if the element of the Data- AVP is permitted to be included in the specific 
command requested by the AS, as indicated in table 7.6.1. 

To manage whether an AS may request each element of Data- AVP with a specific command, the HSS shall maintain a 
list of AS permissions (the "AS Permissions List"). AS permissions are identified by AS identity and Data Reference 
with the possible permissions associated with each Data Reference being Sh-Pull, Sh-Update, Sh-Subs-Notif or any 
combination of these permissions (see table 7.6.1 for details of which permissions are allowed for each Data 
Reference). The permissions apply to all users served by the HSS, they are not user specific. When an AS requests Sh- 
Pull, Sh-Update or Sh-Subs-Notif the HSS shall check permissions and return an error result if the AS does not have the 
required permission. If the AS permissions change in a later stage, i.e. the AS does not longer have the required 
permission, the HSS shall remove all the subscription to notifications for the AS for which required permissions have 
been prohibited. 



6.3 



Void 



6.4 



Void 



6.5 User identity to HSS resolution 



The User identity to HSS resolution mechanism enables the AS to find the address of the HSS that holds the subscriber 
data for a given IMS Public User Identity or Public Service Identity when multiple and separately addressable HSSs 
have been deployed by the network operator. The resolution mechanism is not required in networks that utilise a single 
HSS or when an AS is configured to use pre-defined HSS. 

The resolution mechanism described in 3GPP TS 23.228 [8] shall use a Subscription Locator Function (SLF) or a 
Diameter Proxy Agent. 

The AS accesses the SLF via the Dh interface. The Dh interface shall always be used in conjunction with the Sh 
interface. The Dh interface shall be based on Diameter. The SLF functionality shall use the routing mechanism 
provided by an enhanced Diameter redirect agent. 

The SLF or the Diameter Proxy Agent shall be to determine the HSS address. 

To get the HSS address the AS shall send the Sh request normally destined to the HSS to a pre-configured Diameter 
address/name. 
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- If this Sh Request is received by an SLF (acting as a Diameter redirect agent), the SLF determines the HSS 
address and sends to the AS a notification of redirection towards the HSS address, in response to the Sh request. 

- If this Sh Request is received by the Diameter Proxy Agent, the Diameter Proxy Agent shall determine the HSS 
address and shall forward the Sh request directly to the HSS. The AS shall determine the HSS address from the 
response to the Sh request received from the HSS. 

The AS should store the HSS address/name/Realm and shall use it in further Sh requests associated to the same IMS 
Public Identity. 

In networks where the use of the user identity to HSS resolution mechanism is required and the AS is not configured to 
use a predefined HSS, each AS shall be configured with the pre-configured address/name of the SLF or the Diameter 
Proxy Agent to enable use of these resolution mechanisms. 
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7.1 



Information element contents 
User Identity 



This information element contains an IMS Public User Identity, Public Service Identity or MSISDN according to the 
conditions described in table 7.1.1. 

Table 7.1.1 : User Identity content 



Information 
element name 


Mapping to 

Diameter 

AVP 


Cat. 


Description 


IMS Public User 

Identity/ Public 

Service Identity 

(See 7.1.1) 


Public-Identity 


C 


IMS Public User Identity or Public Service Identity for which data is 
required. If the MSISDN is not included in the User-Identity AVP, the 
Public-Identity AVP shall be included in Sh messages only for allowed 
Data References as described in Table 7.6.1 . 


MSISDN 
(See 7.1.2) 


MSISDN 


C 


MSISDN for which data is required. If the Public-Identity AVP is not 
included in the User-Identity AVP, the MSISDN AVP shall be included in 
the Sh-Pull message only for allowed Data References as described in 
Table 7.6.1. 



7.1.1 



IMS Public User Identity / Public Service Identity 



This information element contains an IMS Public User Identity / Public Service Identity (either SIP URI or tel URI). 
See 3GPP 23.003 [11]. 

7.1.2 MSISDN 

This information element contains a Basic MSISDN (see 3GPP TS 23.012 [19]). 

7.1 A Wildcarded PSI 

This information element contains a Wildcarded PSI that is hosted by an application server. For definition of a 
Wildcarded PSI, see 3GPP TS 23.003 [11]. 

7.1 B Wildcarded Public User Identity 

This information element contains a Wildcarded Public User Identity that is stored in the HSS. For definition of a 
Wildcarded Public User Identity, see 3GPP TS 23.003 [11]. 

7.2 Requested Domain 

This information element details the access domains for which certain data (e.g. user state, location information) are 
requested. See 3GPP TS 29.329 [5] for the list of possible values. 



7.3 Requested Data 



- Reference to the data that an AS is requesting from the HSS. 

- Reference to the data which, an AS wants to be notified of, when changed. 

- Reference to data for which subscription to notification of change is rejected. 
See section 7.6. 
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7.4 



Service Indication 



Identifier of one set of service related transparent data, which is stored in an HSS in an operator network per Public 
Identity. The HSS shall allocate memory space to implement a data repository to store transparent data per IMS Public 
User Identity or Public Service Identity and value of Service Indication with a Sequence Number for verification. For 
Public Service Identities matching a Wildcarded Public Service Identity, the repository data shall be stored per 
Wildcarded Public Service Identity and not for each specific Public Service Identity. 



7.5 



Result 



This information element contains the result code of the operation. See 3GPP TS 29.329 [5] for the list of possible 
values. 



7.6 



Data 



This information element contains an XML document conformant to the XML schema defined in Annex D. 

Annex C specifies the UML logical model of the data downloaded via the Sh interface. 

Table 7.6.1 defines the data reference values and tags, access key and recommended AS permissions (as described in 
section 6.2) for the the operation(s) on data accessible via the Sh interface, i.e. the listed operation(s) in the Operations 
column are the only ones allowed to be used with this Data Ref value. It is a matter of operator policy to further restrict 
the AS permission rights defined in table 7.6.1. 

Table 7.6.1 : Data accessible via Sh interface 



Data 
Ref. 


XML tag 


Defined 
in 


Access key 


Operations 





RepositoryData 


7.6.1 


IMS Public User Identity or Public Service Identity + Data- 
Reference + Service-Indication 


Sh-Pull, Sh-Update, 
Sh-Subs-Notif (Notel) 


10 


IMSPublicldentity 


7.6.2 


IMS Public User Identity 

or Public Service Identity or MSISDN + Data-Reference + 

Identity-Set (all values other than ALIASJDENTITIES) 


Sh-Pull, Sh-Subs-Notif 


10 


IMSPublicldentity 


7.6.2 


IMS Public User Identity + Data-Reference + Identity-Set 
(with value ALIASJDENTITIES) 


Sh-Pull, Sh-Subs-Notif 


11 


IMSUserState 


7.6.3 


IMS Public User Identity + Data-Reference 


Sh-Pull, Sh-Subs-Notif 


12 


S-CSCFName 


7.6.4 


IMS Public User Identity or Public Service Identity + Data- 
Reference 


Sh-Pull, Sh-Subs-Notif 
(Notel) 


13 


InitialFilterCriteria 


7.6.5 


IMS Public User Identity or Public Service Identity + Data- 
Reference + Server-Name 


Sh-Pull, Sh-Subs-Notif 
(Notel) 


14 


Location Information 


7.6.6 


MSISDN + Data-Reference+ Requested-Domain + 
CurrentLocation 


Sh-Pull 


15 


UserState 


7.6.7 


MSISDN + Data-Reference+ Requested-Domain 


16 


Charging information 


7.6.8 


IMS Public User Identity or Public Service Identity or 
MSISDN + Data-Reference 


Sh-Pull, Sh-Subs-Notif 


17 


MSISDN 


7.6.9 


IMS Public User Identity or MSISDN + Data-Reference 


Sh-Pull 


18 


PSIActivation 


7.6.10 


Specific Public Service Identity matching a Wildcarded 

Public Service Identity or Wildcarded Public Service 

Identity + Data-Reference 


Sh-Pull, Sh-Subs-Notif 
(Notel) 


18 


PSIActivation 


7.6.10 


Distinct Public Service Identity + Data-Reference 


Sh-Pull, Sh-Update, 
Sh-Subs-Notif 


19 


DSAI 


7.6.11 


Public User Identity or Public Service Identity + Data- 
Reference + DSAI-Tag + Server-Name 


Sh-Pull, Sh-Update, 
Sh-Subs-Notif (Notel) 


20 


AliasesRepositoryData 


7.6.12 


IMS Public User Identity + Data-Reference + Service- 
Indication 


Sh-Pull, Sh-Update, 
Sh-Subs-Notif 


21 


ServiceLevelTracelnfo 


7.6.13 


IMS Public User Identity or MSISDN + Data Reference 


Sh-Pull, Sh-Subs-Notif 


Note 1 : If an AS subscribes to a Specific PSI matching a Wildcarded PSI, the notification shall be sent as if the subscription was 

made to the corresponding Wildcarded PSI. 
Note 2: If not specified otherwise Public User Identity and Public Service Identity refer also to the wildcarded identities. 



7.6.1 Repository Data 

This information element contains transparent data. A data repository may be shared by more than one AS 
implementing the same service. 
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7.6.2 IMSPublicldentity 



This information element contains an IMS Public User Identity or a Public Service Identity. If a wildcarded PSI that is 
stored in the HSS matches the Public Service Identity received, the HSS shall return the wildcarded PSI in addition to 
the Public Service Identity that was received in the request. If a Wildcarded Public User Identity that is stored in the 
HSS matches the Public User Identity received, the HSS shall return the Wildcarded Public User Identity in addition to 
the Public User Identity that was received in the request. 

An IMS Public Identity would be either: 

associated with the same Private User Identity or Private Service Identity as the User Identity included in the 
request or 

associated with the MSISDN present in the request. 

Multiple instances of this information element may be included in the message. 

7.6.3 IMS User State 

This information element contains the IMS User State of the public identifier referenced. Its possible values are: 

- REGISTERED, 

- NOT_REGISTERED, 

- AUTHENTICATION_PENDING, 

- REGISTERED_UNREG_SERVICES . 

If the IMS Public User Identity is shared between multiple Private User Identities, HSS shall indicate the most 
registered state of the shared IMS Public User Identity to an AS. The most registered state of a shared IMS Public User 
Identity is defined as follows: 

If the shared IMS Public User Identity is registered with any of the Private User Identities, the most registered 
state of the shared IMS Public User Identity is REGISTERED. 

If the shared IMS Public User Identity is not currently registered with any of the Private User Identities, but it is 
in state REGISTERED_UNREG_SERVICES, then the most registered state of the shared IMS Public User 
Identity is REGISTERED_UNREG_SERVICES . 

- If the shared IMS Public User Identity is not currently registered with any of the Private User Identities, and it is 
not in state REGISTERED_UNREG_SER VICES, but it is in the process of being authenticated with any of the 
Private User Identities, then the most registered state of the shared IMS Public User Identity is 
AUTHENTICATION_PENDING. 

- If the shared IMS Public User Identity is not currently registered with any of the Private User Identities, and it is 
not in state REGISTERED_UNREG_SER VICES, and it is not in the process of being authenticated with any of 
the Private User Identities, then the most registered state of the shared IMS Public User Identity is 
NOT_REGISTERED. 

7.6.4 S-CSCF Name 

This information element contains the name of the S-CSCF assigned to the IMS Subscription. 

7.6.5 Initial Filter Criteria 

This information element contains the triggering information for a service. 

For a more detailed description, refer to 3GPP TS 23.218 [4] and 3GPP TS 29.228 [6]. 
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7.6.6 Location Information 

This information element contains the location of the served subscriber in the MSC/VLR if the requested domain is CS, 
or the location of the served subscriber in the SGSN if the requested domain is PS. If the HSS has to communicate with 
the MSC/VLR and/or SGSN to retrieve location information, it shall make use of the service MAP-PRO VIDE- 
SUBSCRIBER-INFO. 

For both Location Information for CS and Location Information for GPRS, the considerations described in 3 GPP TS 
23.078 [14] apply. 

7.6.6.1 Location information for CS 

This information element consists of the following subordinate information elements: 

- Location number: defined in ITU-T Recommendation Q.763 [9]. Considerations described in 3GPP TS 23.018 

apply [10]. 

- Service area ID: defined in 3GPP TS 23.003 [11]. 

- Global Cell ID: defined in 3GPP TS 23.003 [11]. 

- Location area ID: defined in 3GPP TS 23.003 [11]. 

- Geographical Information: defined in 3GPP TS 23.032 [12]. Considerations described in 3GPP TS 23.018 [10] 
and 3GPP TS 29.002 [13] apply. 

Geodetic Information: defined in ITU-T Recommendation Q.763 [9]. Considerations described in 3GPP TS 
23.018 [10] and 3GPP TS 29.002 [13] apply. 

- VLR Number: defined in 3GPP TS 23.003 [11]. 

- MSC Number: defined in 3GPP TS 23.003 [11]. 

- Age of location information: defined in 3GPP TS 23.018 [10]. 

- Current Location Retrieved: shall be present when location information was obtained after a successful paging 
procedure for Active Location Retrieval. 

7.6.6.2 Location information for GPRS 

This information element consists of the following subordinate information elements: 

- Service area ID: defined in 3GPP TS 23.003 [11]. 

- Global Cell ID: defined in 3GPP TS 23.003 [11]. 

- Location area ID: defined in 3GPP TS 23.003 [11]. 

- Geographical Information: defined in 3GPP TS 23.032 [12]. Considerations described in 3GPP TS 23.018 [10] 
and 3GPP TS 29.002 [13] apply. 

Geodetic Information: defined in ITU-T Recommendation Q.763 [9]. Considerations described in 3GPP TS 
23.018 [10] and 3GPP TS 29.002 [13] apply. 

- SGSN Number: defined in 3GPP TS 23.003 [11]. 

- Routing Area ID: defined in 3GPP TS 23.003 [11]. 

- Current Location Retrieved: shall be present when location information was obtained after a successful paging 
procedure for Active Location Retrieval. 

7.6.7 User state 

This information element indicates the state of the User Identity in the domain indicated by the Requested-Domain (see 
7.2), with the values specified in 3GPP TS 23.078 [14] for Subscriber State and PS Domain Subscriber State. The HSS 
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shall make use of the operation MAP-PROVIDE-SUBSCRIBER-INFO towards the MSC/VLR and/or the SGSN to 
obtain this information. 

7.6.8 Charging information 

This information element contains the addresses of the charging functions: primary Online Charging Function 
(PrimaryEventChargingFunctionName), secondary Online Charging Function 
(SecondaryEventChargingFunctionName), primary Charging Data Function 
(Primary ChargingCollectionFunctionName), and secondary Charging Data Function 

(SecondaryChargingCollectionFunctionName). When a clash occurs between the charging function address(es) 
received over the ISC interface and those received over the Sh interface, the address(es) received over the ISC interface 
should take precedence. 

NOTE: The use of the Sh interface to retrieve charging function addresses is not intended as a general-purpose 

alternative to receiving charging function addresses from the ISC interfaces. Rather, it is meant to address 
a special case where the AS needs to interact with the charging system before initiating a request to a user 
when the AS has not received the third party REGISTER for that user. 

The AS shall extract the FQDN of the DiameterURI in these information elements and may use it as content of the 
Destination-Host AVP for the Diameter accounting requests. The parent domain of the FQDN in the DiameterURI shall 
be used as Destination-Realm. The number of labels used for the Destination-Realm shall be determined before the 
Charging Information is provisioned and may be a configuration option. 

NOTE: A FQDN is an absolute domain name including a subdomain and its parent domain. The subdomain and 
the parent domain contain one or more labels separated by dots. 

7.6.9 MSISDN 

This information element contains a Basic MSISDN (see 3 GPP TS 23.012 [19]) that is associated with the User Identity 
present in the request. All valid instances of this information element shall be included in the message. 

7.6.10 PSI Activation 

This information element contains the activation state of the Public Service Identity present in the request. Its possible 
values are: 

- ACTIVE, 

- INACTIVE. 

7.6.11 DSAI 

When a service is provisioned but not active, an Application Server is typically involved through the ISC interface in 
sessions where the Application Server is not supposed to perform any task but to proxy incoming transactions. 

In order to avoid this disoptimization, a mechanism is provided for the Application Server to signal the HSS that a set of 
initial filter criteria should be 'masked' for a specific Public User Identity or Public Service Identity. This is, from the 
Application Server" s perspective, just an indication, and an Application Server must be prepared to be involved in 
sessions even if the trigger that caused its involvement has been masked by that Application Server. 

This information element contains the activation state of a Service (identified by its DSAI-tag, see section 7.14, for a 
specific user identified by a Public User Identity or of a Service identified by its PSI). Its possible values are: 

- ACTIVE, 

- INACTIVE. 

In the HSS the DSAI can also be associated to a wildcarded PSI. In that case, there is a set of identities matching a 
specific wildcarded PSI and all the identities in the set share the same DSAIs. Any change in these DSAIs masked from 
a single identity of the set will apply to all the identities associated to that wildcarded PSI. 
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Each DSAI is implicitly bound to a list of (at least one) initial filter criteria. The binding is not exclusive, i.e. one 
instance of initial filter criteria may be bound to zero or more DS AIs, however all the iFCs bound to a given DSAI 
should trigger to the same AS (i.e. they should share the same ServerName), which is the only one allowed to update it. 

An instance of initial filter criteria shall be included into the Service-Profile sent through the Cx Interface according to 
the operations described in 3GPP TS 29.228 [6] if at least one of the following conditions applies: 

- No DSAI is bound to those initial filter criteria; 

- At least one of the DS AIs bound to those initial filter criteria is set to ACTIVE. 

7.6.12 Aliases Repository Data 

This information element contains transparent data associated to a set of Alias IMS Public User Identities (see 3GPP TS 
23.228 [1] for the definition of Alias Public User Identities). A data repository may be shared by more than one AS 
implementing the same service. 

7.6.13 Service Level Trace Information 

This information element contains the Service Level Tracing Information (see IETF draft-dawes-sipping-debug-event 
[21]) that is related to a specific Public Identifier. If the ServiceLevelTracelnfo is present, service level tracing shall be 
enabled in the Application Server for the related Public Identifier according to the configuration data received. If the 
ServiceLevelTracelnfo is not present, service level tracing is disabled in the Application Server for the related Public 
Identifier. 



7.7 Subscription request type 



This information element indicates the action requested for subscription to notifications. See 3GPP TS 29.329 [5] for 
the list of valid values. 

7.8 Current Location 

This information element indicates whether an active location retrieval has to be initiated or not when an AS requested 
location information. See 3GPP TS 29.329 [5] for the list of possible values. 



7.9 Application Server Identity 



This information element contains the identity of the Application Server. It is used for the AS permission check (see 
6.2). 



7.1 Application Server Name 



This information element indicates application server's SIP URL See 3GPP TS 29.229 [7] for the detailed definition of 
the AVP. 



7.1 1 Requested Identity Set 



This information element indicates the set of IMS Public Identities that the AS wishes to download. See 3GPP TS 
29.329 [5] for the detailed definition of the AVP. 



7.12 Expiry Time 



This information element indicates the expiry time of the subscription to notifications in the HSS. See 3GPP TS 29.329 
[5] for the detailed definition of this AVP. 
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7.13 Send Data Indication 

This information element indicates the request that the User Data is sent in the response. See 3GPP TS 29.329 [5] for 
the detailed definition of this AVP. 

7.14 DSAITag 

An instance of Dynamic Service Activation Info is uniquely identified by the Public User/Service Identity and a DS AI 
tag. The same DS AI tag may be used for all the user profiles when indicating the same type of information, but not all 
the user profiles may contain the same set of tags. 

Application Servers shall signal that they are not interested in being involved in new sessions by manipulating Dynamic 
Service Activation Info (DSAI) inside of dynamic service information data, see section 7.6.11. 



8 Protocol version identification 

See 3GPPTS 29.329 [5]. 



9 Operational Aspects 

See 3GPPTS 29.329 [5]. 
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Annex A (normative): 

Mapping of Sh operations and terminology to Diameter 



A.1 Introduction 



This appendix gives mappings from Sh to Diameter protocol elements. Diameter protocol elements are defined in 3 GPP 
TS 29.329 [5]. 



A.2 Sh message to Diameter command mapping 

The following table defines the mapping between stage 2 operations and Diameter commands: 



Table A.2.1 : Sh message to Diameter command mapping 



Sh message 


Source 


Destination 


Command-Name 


Abbreviation 


Sh-Pull 


AS 


HSS 


User-Data-Request 


UDR 


Sh-Pull Resp 


HSS 


AS 


User-Data-Answer 


UDA 


Sh-Update 


AS 


HSS 


Profile-Update-Request 


PUR 


Sh-Update Resp 


HSS 


AS 


Profile-Update-Answer 


PUA 


Sh-Subs-Notif 


AS 


HSS 


Subscribe-Notifications-Request 


SNR 


Sh-Subs-Notif Resp 


HSS 


AS 


Subscribe-Notifications-Answer 


SNA 


Sh-Notif 


HSS 


AS 


Push-Notification-Request 


PNR 


Sh-Notif Resp 


AS 


HSS 


Push-Notification-Answer 


PNA 



A.3 Void 
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Annex B (informative): 
Message flow 

B.1 Message flows 

The following message flows give examples regarding which Diameter messages shall be sent in scenarios described in 
3GPPTS 23.218 [4]. 

B.1 .1 Data Update, Registration, Notification Subscription. 

Home Network 



wsc 



3. REGISTER 



5 , 7,00 OK 



Jser Profile Downlo; 



HSS_ 



7. 200 OK 



AS 



1.Sh- Update 



?. Sh-lJpriate Ray 



Lding 



6. REGISTER 
(Third Party) 



1 8. Sh-Subs Notif 



9. Sh-Subs_Notif Fesp + User-Data 



Send data Ind. 



At some point, the AS decides to update certain data in the HSS 



At some point, the HS3 sends updates to the AS (that previously 



10. Sh- Update 



11. Sh- Update Res 



12. Sh- Notif 



13. Sh-Notif Resp 



ubscribed) 



Figure B.1.1: Data Update, Registration, Notification Subscription 

1. A user subscribes to a new service. The operator provisions the service in an AS. The AS stores some service 
data for a user in the HSS, Sh-Update (user identity, updated data) e.g. repository data. 

2. HSS confirms the data is updated 

3. Some time later, user registers with the network 



ETSI 



3GPP TS 29.328 version 8.3.0 Release 8 30 ETSI TS 1 29 328 V8.3.0 (2009-01 ) 

4. S-CSCF downloads the data from the HSS (during the procedure S-CSCF Registration Notification on Cx 
interface). Filter criteria specify that the AS wants to be notified that the end user is registered. 

5. 200 OK 

6. S-CSCF sends third party registration message to the application server to notify that user is registered. 

7. 200 OK 

8. The AS subscribes to notifications and downloads data needed for providing service from HSS, by means of Sh- 
Subs-Notif (user identity, requested data, service information and send data indication). 

9. HSS confirms the subscription request and sends data to AS 

10. At some moment, the AS decides to update user"s service data e.g. repository data in the HSS, by means of Sh- 
Update (user identity, updated data). 

1 1. The HSS confirms the service data is updated. 

12. At some moment, user data is updated in the HSS. As the AS subscribed to notifications (step 8), the HSS sends 
to the AS the requested updates, by means of Sh-Notif (user identity, updated data). 

13. The AS acknowledges the notification. 
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Annex C (informative): 

UML model of the data downloaded over Sh interface 

The purpose of this UML model is to define in an abstract level the structure of the data downloaded over the Sh 
interface and describe the purpose of the different information classes included in it. 

C.1 General description 

The following picture gives an outline of the UML model of the user profile, which is exchanged between the HSS and 
an AS: 
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Sh-Data 



0..1 



Publicldentifiers 



0..1 



Registeredldentities 



0..1 



Implicitldentities 



0..1 



Allldentities 



0..1 



Aliasldentities 



0..1 



Deletedldentities 



0..1 



0..n 



RepositoryData 



Service Indication 

SequenceNumber 

ServiceData 



0..1 



PSLocation Information 



GlobalCellld 

ServiceAreald 

LocationAreald 

RoutingAreald 

Geographical Information 

Geodeticlnformation 

AgeOf Location Information 

CurrentLocationRetrieved 

SGSNNumber 



Sh-IMS-Data 



0..1 



CSUserState 
state: enumerated 



0..n 



Aliases RepositoryData 



Servicelndication 

SequenceNumber 

ServiceData 



0..1 
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GlobalCellld 

ServiceAreald 

LocationAreald 

LocationNumber 
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CurrentLocationRetrieved 

VLRNumber 

MSCNumber 




Figure C.1.1: Sh-Data 

Each instance of the Sh-Data class contains or 1 instance of the class Publicldentifiers, or n instances of the class 
RepositoryData, or n instances of the class AliasesRepositoryData, or 1 instance of the class Sh-IMS-Data, or 1 
instance of the class CSUserState, or 1 instance of the class PSUserState or 1 instance of the class 
CSLocationlnformation and or 1 instance of the class PSLocationlnformation, or 1 instance of the class 
Registeredldentities, or 1 instance of the class Implicitldentities, or 1 instance of the class Allldentities, or 1 
instance of the class Aliasldentities, and or 1 instance of the class Deletedldentities. 

If AS and HSS both support the Notif-Eff feature and AS requires more than one identity sets of a public identity, or it 
has subscribed to be notifed of changes to IMSPublicIdentity (see table 7.6.1), the class Publicldentifiers shall not be 
used. Instead the classes Registeredldentities, Implicitldentities, Allldentities and Aliasldentities shall be used and they 
contain the REGISTEREDJDENTITIES, IMPLICITJDENTITIES, ALLJDENTITIES and ALIASJDENTITIES 
associated with the IMS Public Identity included in the request respectively, See Table 6.1.1.1 for the detailed 
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information. The class Publicldentifiers or the one among the four which may be used to contain the correspongding 
identity set can both be used when AS requires only one identity set of a public identity. 

If AS or HSS do not support the Notif-Eff feature, the classes Registeredldentities, Implicitldentities and Allldentities 
shall not be used. Instead the class Publicldentifiers shall be used. 

If Public Identity(ies) are deleted and the AS hassubscribed to be notified of changes to IMSPublicIdentity(see table 
7.6.1), the class Deletedldentities shall not be used.If Public Identity(ies) are deleted and the AS has not subscribed to 
be notified of changes to IMSPublicIdentity but has any other subscription active for the deleted identity (ies), the HSS 
shall notify the AS of the deletion of the identity(ies) using the class Deletedldentities. 

Class RepositoryData contains repository data (transparent data) for a given service. It has attributes Servicelndication, 
SequenceNumber and ServiceData.Class AliasesRepositoryData contains repository data (transparent data) for a given 
service that are associated to a group of Public User Identities. It has attributes Servicelndication, SequenceNumber and 
ServiceData. 

Class CSUserState contains the state of a user in the CS domain. Its only attribute, State, is an enumeration whose 
possible values are defined in section 7.6.7. 

Class PSUserState contains the state of a user in the PS domain. Its only attribute, State, is an enumeration whose 
possible values are defined in section 7.6.7. 

NOTE: the fact that attribute State is an enumeration is a difference from what can be carried in the MAP protocol. 

Class CSLocationlnformation has the attributes Location Number, Service Area ID, GlobalCellld, LocationAreald, 
Geographicallnformation, Geodeticlnformation, VLR Number, MSC Number, AgeOfLocationlnformation and 
CurrentLocationRetrieved. They are defined in 7.6. 

Class PSLocationlnformation has the attributes ServiceAreald, GlobalCellld, Location ArealD, Routing ArealD, 
Geographicallnformation, Geodeticlnformation, SGSN Number, AgeOfLocationlnformation and 
CurrentLocationRetrieved. They are defined in 7.6. 

Class Deletedldentities contains Public Identities (IMS Public User Identities or Public Service Identities) removed 
from the HSS. 
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C.2 Publicldentifiers 



The following picture details the UML model of the class Publicldentifiers: 



Publicldentifiers 



0..n 



IMSPublicldentity 



Identity: SIP URL or Tel URL 
Identity Type 
Wildcarded PSI 
Wildcarded Public User Identity 



0..n 



MSISDN 



Figure C.2.1 : The UML model of the class Publicldentifiers 

Class Publicldentifiers contains or more public user identities which may be either of class IMSPublicldentity or of 
class MSISDN. The identifiers are of format SIP URL, tel URI or MSISDN. Instances of class IMSPublicldentity shall 
contain a Public User Identity, a distinct PSI or an identity matching a Wildcarded PSI or a Wildcarded Public User 
Identity in the HSS. They shall contain the Identity Type and the wildcarded identity if the Identity in the request 
matches a wildcarded identity in the HSS. 
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C.3 Sh-IMS-Data 



The following picture details the UML model of the class Sh-IMS-Data. 



Sh-IMS-Data 



0..1 

S-CSCFName 
ServerName: SIPJJRL 



0..1 



IMSUserState 



IMSState: enumerated 



0..1 



IFCs 



IFCs:tlFCs 



0..1 



0..1 



PSIActivation 



PSIState: enumerated 



Charging Information 



Charging Information : 
tCharginglnformation 



0..1 



Service Level Trace 
Information 



ServiceLevelTracelnfo: 
string 



0..n 



DSAI 



DSAI Tag: string 
DSAI Value: enumerated 



Figure C.3.1 : Sh-IMS-Data 

Each instance of the class Sh-IMS-Data contains or 1 instance of the class S-CSCFName, to 1 instance of the class 
IFCs, or 1 instance of the class IMSUserState, or 1 instance of the class Charginglnformation and/or or 1 instance 
of the class PSIActivation. 

Class S-CSCFName contains a SIP URL See section 7.6.4 for further details. 

Class IFCs contains to n instances of the initial filter criteria of the multimedia public identity that the AS included in 
the request. The initial filter criteria is defined in 3GPP TS 29.228 [6]. 

Class IMSUserState contains the registration state of the identity given by the attribute of class Sh-IMS-Data. See 
section 7.6 for possible values. 

Class Charging Information contains the online and offline charging function addresses. See section 7.6 for possible 
values. 

Class PSIActivation contains the activation state of the Public Service Identity given by the attribute of class Sh-IMS- 
Data. See section 7.6 for possible values. 

Class DSAI contains the DSAI Tag and a DSAI Value (reflecting the activation state) for services the user is subscribed 
to. See section 7.14 for contents and usage. 

Class ServiceLevelTracelnfo contains the Service Level Trace configuration information to enable the Application 
Server to perform service level tracing related to a specific Public Identifier. See section 7.6.x for contents and usage. 
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Annex D (normative): 

XML schema for the Sh interface user profile 

The file ShDataType_Rel8.xsd, attached to this specification, contains the XML schema for the user profile that is sent 

over the Sh interface. The user profile XML schema defines the data types that are used in the user profile XML. 

The data that is allowed to be sent in the user profile may vary depending on the features supported by the Diameter end 

points, see 3GPP TS 29.329 [5]. The user profile XML schema file is intended to be used by an XML parser. 

The version of the Sh application sending the user profile XML shall be the same as the version of the sent user profile 

XML and thus it implies the version of the user profile XML schema to be used to validate it. 

Tables D.l and D.2 describe the data types and the dependencies among them that configure the user profile XML 
schema. 

Table D.1 : XML schema for the Sh user profile interface: simple data types 



Data type 


Tag 


Base type 


Comments 


tPriority 


Priority 


integer 


>=o 


tProfilePartlndicator 


ProfilePartlndicator 


enumerated 


Possible values: 

(REGISTERED) 

1 (UNREGISTERED) 


tGroupID 


Group 


integer 


>=0 


tRegistrationType 


RegistrationType 


enumerated 


Possible values: 

(INITIAL REGISTRATION) 

1 (RE-REGISTRATION) 

2 (DE-REGISTRATION) 


tDefaultHandling 


DefaultHandling 


enumerated 


Possible values: 

(SESSION CONTINUED) 

1 (SESSION TERMINATED) 


tDirectionOfRequest 


SessionCase 


enumerated 


Possible values: 

(ORIGINATING SESSION) 

1 TERMINATING SESSION 

2 (TERMINATING UNREGISTERED) 

3 (ORIGINATINGJJNREGISTERED) 


tIMSUserState 


IMSUserState 


Enumerated 


Possible values: 

(NOT REGISTERED) 

1 (REGISTERED) 

2 (REGISTERED UNREG SERVICES) 

3 (AUTHENTICATION_PENDING) 


tCSUserState 


CSUserState 


Enumerated 


Possible values (as defined in 3GPP TS 23.078 [14]): 

(CAMELBusy) 

1 (NetworkDeterminedNotReachable) 

2 (Assumedldle) 

3 (NotProvidedfromVLR) 


tPSUserState 


PSUserState 


Enumerated 


Possible values (as defined in 3GPP TS 23.078 [14]): 

(Detached) 

1 (AttachedNotReachableForPaging) 

2 (AttachedReachableForPaging) 

3 (ConnectedNotReachableForPaging) 

4 (ConnectedReachableForPaging) 

5 (NotProvidedFromSGSN) 

6 (NetworkDeterminedNotReachable) 


tLocationNumber 


LocationNumber 


string 


Syntax described in ITU-T Q.763 [9] (Base64 encoded 
according to RFC 2045 [15]). 
Length >=4 and <=16 (multiples of 4). 


tCellGloballd 


CellGloballd 


string 


Syntax described in 3GPP TS 29.002 [13] (Base64 
encoded according to RFC 2045 [15]). 
Length = 12. 


tServiceAreald 


ServiceAreald 


string 


Syntax described in 3GPP TS 29.002 [13] (Base64 
encoded according to RFC 2045 [15]). 
Length = 12. 


tLocationAreald 


LocationAreald 


string 


Syntax described in 3GPP TS 29.002 [13] (Base64 
encoded according to RFC 2045 [15]). 
Length = 8. 


tRoutingAreald 


RoutingAreald 


string 


Syntax described in 3GPP TS 29.002 [13] (Base64 
encoded according to RFC 2045 [15]). 
Length = 8. 


tGeographicallnformation 


Geographicallnformation 


string 


Syntax described in 3GPP TS 29.002 (base 64 
encoded according to RFC 2045). 
Length = 12. 
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tGeodeticlnformation 


Geodeticlnformation 


string 


Syntax described in 3GPP TS 29.002 [13] (Base64 
encoded according to RFC 2045 [15]). 
Length = 16. 


tAgeOf Location I nf ormation 


AgeOf Location Information 


integer 


>=0, <=32767 


tAddressString 


AddressString 


string 


Syntax described in 3GPP TS 29.002 [13] (Base64 
encoded according to RFC 2045 [15]). 
Length >= 4 and <=28 (multiples of 4). 


tMSISDN 


MSISDN 


string 


Number structure described in 3GPP TS 23.003 [11]. 
ASCII encoded according to ANSI X3.4 [20]. 


tSIP URL 


IMSPublicldentity 


anyURI 


Syntax described in RFC 3261 [16] 


tTEL URL 


IMSPublicldentity 


anyURI 


Syntax described in IETF RFC 3966 [17] 


tDiameterURI 


DiameterURI 


string 


Syntax of a Diameter URI as described in IETF RFC 
3588 [8] 


tIMSPublicldentity 


IMSPublicldentity 


(union) 


Union of tSIP URL and tTEL URL 


tldentityType 


IdentityType 


enumerated 


Possible values: 

(PUBLIC USER IDENTITY) 

1 (DISTINCT PSI) 
2(WILDCARDED PSI) 

3 (WILDCARDEDJMPU) 


tWildcardedPSI 


WildcardedPSI 


anyURI 


Syntax described in 3GPP TS 23.003 [11]. 


tWildcardedlMPU 


WildcardedlMPU 


anyURI 


Syntax described in 3GPP TS 23.003 [11]. 


tServicelnfo 


Service Info 


string 




tDSAI-Tag 


DSAI-Tag 


string 




tString 


RequestURI, Method, Header, 
Content, Line 


string 




tBool 


ConditionTypeCNF, 
ConditionNegated 


boolean 


Possible values: 

(false) 

1 (true) 


tSequenceNumber 


SequenceNumber 


integer 


>=0, <=65535 


tPSIActivation 


PSIActivation 


Enumerated 


Possible Values: 

(INACTIVE) 

1 (ACTIVE) 


tDSAI-Value 


DSAI-Value 


enumerated 


Possible values are: 

(ACTIVE) 

1 (INACTIVE) 


tServiceLevelTracelnfo 


ServiceLevelTracelnfo 


String 


Syntax described in IETF draft-dawes-sipping-debug- 
event[21] 
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Table D.2: XML schema for the Sh user profile interface: complex data types 



Data type 


Tag 


Compound of 


Tag 


Type 


Cardinality 


tSh-Data 


Sh-Data 


Publicldentifiers 


tPublicldentity 


Oto 1 


RepositoryData 


tTransparentData 


Oto n 


Sh-IMS-Data 


tShlMSData 


Oto 1 


CSLocationlnformation 


tCSLocationlnformation 


0to1 


PSLocationlnformation 


tPSLocationlnformation 


0to1 


CSUserState 


tCSUserState 


Oto 1 


PSUserState 


tPSUserState 


0to1 


Extension 


tSh-Data-Extension 


Oto 1 


tSh-Data-Extension 


Extension 


Registeredldentites 


tPublicldentity 


0to1 


Implicitldentities 


tPublicldentity 


Oto 1 


Allldentities 


tPublicldentity 


Oto 1 


Aliasldentities 


tPublicldentity 


0to1 


AliasesRepositoryData 


tTransparentData 


Oto n 


Extension 


tSh-Data-Extension2 


0to1 


tSh-Data-Extension2 


Extension 


Deletedldentities 


tPublicldentity 


0to1 


tTransparentData 


RepositoryData 


Servicelndication 


string 


1 


SequenceNumber 


tSequenceNumber 


1 


ServiceData 


tServiceData 


Oto 1 


tTransparentData 


AliasesRepositoryData 


Servicelndication 


string 


1 


SequenceNumber 


tSequenceNumber 


1 


ServiceData 


tServiceData 


0to1 


tServiceData 


any 


any 


any 


1 


tIFCs 


IFCs 


InitialFilterCriteria 


tlnitialFilterCriteria 


Oto n 


tShlMSData 


Sh-IMS-Data 


SCSCFName 


tSIP URL 


0to1 


IFCs 


tIFCs 


Oto 1 


IMSUserState 


tIMSUserState 


0to1 


Charginglnformation 


tCharginglnformation 


0to1 


Extension 


tShlMSDataExtension 


(Oto 1) 


tShlMSDataExtension 


Extension 


PSIActivation 


tPSIActivation 


(0to1) 


Extension 


tShlMSDataExtension2 


Oto 1 


tShlMSDataExtension2 


Extension 


DSAI 


tDSAI 


Oto n 


Extension 


tShlMSDataExtension3 


(Oto 1) 


tShlMSDataExtension3 


Extension 


ServiceLevelTracelnfo 


tServiceLevelTracelnfo 


(0to1) 


tCSLocationlnformation 


CSLocationlnformation 


LocationNumber 


tLocationNumber 


0to1 


CellGloballd 


tCellGloballd 


Oto 1 


ServiceAreald 


tServiceAreald 


0to1 


LocationAreald 


tLocationAreald 


Oto 1 


Geographicallnformation 


tGeographicallnformation 


0to1 


Geodeticlnformation 


tGeodeticlnformation 


0to1 


VLRNumber 


tISDNAddress 


Oto 1 


MSCNumber 


tISDNAddress 


0to1 


CurrentLocationRetrieved 


tBool 


Oto 1 


AgeOf Location Information 


tAgeOf Location I nf ormation 


0to1 


tPSLocationlnformation 


PSLocationlnformation 


CellGloballd 


tCellGloballd 


Oto 1 


ServiceAreald 


tServiceAreald 


Oto 1 


LocationAreald 


tLocationAreald 


0to1 


RoutingAreald 


tRoutingAreald 


Oto 1 


Geographicallnformation 


tGeographicallnformation 


0to1 


Geodeticlnformation 


tGeodeticlnformation 


Oto 1 


SGSNNumber 


tISDNAddress 


0to1 


CurrentLocationRetrieved 


tBool 


0to1 


AgeOf Location Information 


tAgeOf Location I nf ormation 


Oto 1 


tPublicldentity 


Publicldentifiers 


IMSPublicldentity 


tIMSPublicldentity 


Oto n 


MSISDN 


tMSISDN 


Oto n 


Extension 


tPublicldentityExtension 


(0to1) 


tPublicldentityExtension 


Extension 


IdentityType 


tldentityType 


(0to1) 


WildcardedPSI 


tWildcardedPSI 


(Oto 1) 


Extension 


tPublicldentityExtension2 


(0to1) 


tPublicldentityExtension2 


Extension 


WildcardedlMPU 


tWildcardedlMPU 


(0to1) 


tlnitialFilterCriteria 


InitialFilterCriteria 


Priority 


tPriority 


1 


TriggerPoint 


tTrigger 


Oto 1 


ApplicationServer 


tApplicationServer 


1 


ProfilePartlndicator 


tProfilePartlndicator 


0to1 


tTrigger 


TriggerPoint 


ConditionTypeCNF 


tBool 


1 


SPT 


tSePoTri 


Oto n 


tSePoTri 


SPT 


ConditionNegated 


tBool 


Oto 1 


Group 


tGroupID 


1 ton 
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o 

CD 
O 

'o 

_c 
O 


RequestURI 


tString 


1 


Method 


tString 


1 


SIPHeader 


tHeader 


1 


SessionCase 


tDirectionOfRequest 


1 


SessionDescription 


tSessionDescription 


1 


Extension 


tSePoTri Extension 


(0to1) 


tSePoTri Extension 


Extension 


RegistrationType 


tRegistrationType 


(0 to 2) 


tHeader 


SIPHeader 


Header 


tString 


1 


Content 


tString 


0to1 


tSessionDescription 


SessionDescription 


Line 


tString 


1 


Content 


tString 


0to1 


tApplicationServer 


ApplicationServer 


ServerName 


tSIP URL 


1 


DefaultHandling 


tDefaultHandling 


Oto 1 


Service Info 


tServicelnfo 


0to1 


tCharginglnformation 


Charginglnformation 


PrimaryEventChargingFunctionName 


tDiameterURI 


Oto 1 
(note 2) 


SecondaryEventChargingFunctionName 


tDiameterURI 


0to1 


PrimaryCharging 
CollectionFunctionName 


tDiameterURI 


Oto 1 
(note 2) 


SecondaryCharging 
CollectionFunctionName 


tDiameterURI 


Oto 1 


tDSAI 


DSAI 


DSAI-Tag 


tDSAI-Tag 


1 


DSAI-Value 


tDSAI-Value 


1 


NOTE 1 : 'n' shall be interpreted as non-bounded. 

NOTE 2: At least one of these two information elements (PrimaryEventChargingFunctionName or 
PrimaryChargingCollectionFunctionName) shall be present. 
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Annex E: 
Void 
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